home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 21 / Cream of the Crop 21 (Terry Blount) (October 1996).iso / games / mdlv13.zip / MDL.TXT < prev    next >
Text File  |  1996-07-11  |  8KB  |  219 lines
  1. -----------------------------------------------------------------------------
  2. MedDLe v1.3
  3. -----------------------------------------------------------------------------
  4.  
  5.   by brian martin
  6.   brian@phyast.pitt.edu
  7.   http://www.phyast.pitt.edu/~brian
  8.  
  9.   Disclaimer: The author takes no responsiblity for misuse of
  10.   this program. He also is not responsible for any damage caused by it.
  11.  
  12.   NOTE: this won't save files because quake registered isn't out!
  13.         and it won't read the flame mdls.
  14.     This is just a patched up version of the old mdl. A newer one
  15.     is in the works.
  16. -----------------------------------------------------------------------------
  17. Quick Start:
  18. -----------------------------------------------------------------------------
  19.  
  20. edit mdl.cfg to fit your needs
  21. run mdl (i.e. "mdl player.mdl")
  22. hit key '1' for help
  23.  
  24. -----------------------------------------------------------------------------
  25. Contents:
  26. -----------------------------------------------------------------------------
  27.  
  28.         1. About MedDLe
  29.         2. Installation
  30.         3. Basic Use
  31.         4. Editing MDL files
  32.         5. History
  33.  
  34. -----------------------------------------------------------------------------
  35. 1. About
  36. -----------------------------------------------------------------------------
  37.  
  38. MedDLe is a program which lets you look at and edit the mdl
  39. files in quake. These are the files which describe the objects
  40. in quake and are located in the QUAKE\PROGS directory. You have to first
  41. unpack the id1.pak file with a program like unpack or qube. These can both
  42. be found at ftp.cdrom.com.
  43.  
  44. Features :
  45.         View bitmaps (object textures)
  46.         View/edit point mapping of the vertices
  47.         View/edit polygon mapping
  48.         Export model textures to a BMP file
  49.         Import BMP files to give objects a new 'skin'
  50.         View mdl header information
  51.         3D View of object (vertex/wire frame/flat shaded/texture mapped views)
  52.         Animation frame browser
  53.  
  54. -----------------------------------------------------------------------------
  55. 2. Installation
  56. -----------------------------------------------------------------------------
  57.  
  58. You should stick MedDLe in its own directory. Just unzip MDLv02.ZIP
  59. in a suitable directory (i.e. c:\mdl).  You should have these files
  60. in the MedDLe directory:
  61.  
  62.     MDL.EXE     -the executable
  63.     MDL.CFG     -the configuration file
  64.     MDL.FNT         -the fonts
  65.     MDL.PAL         -the palette
  66.     MDL.MAP         -the colormap
  67.     MDLSRC.ZIP      -the source code
  68.     CWSDPMI.EXE     -dpmi environment (not needed if in windows)
  69.  
  70. If everything is in place, bring up MDL.CFG in a text editor and set
  71. the path variable and video driver to match your system. You can set
  72. the video resolution here too. When your done, save the file. That's it!
  73.  
  74. note: You may need a 386/483sx and math co-procesor or a 486dx or higher
  75. to run this. I don't know. There are several math emulators on the net
  76. if it doesn't work on your numerically challenged machine.
  77.  
  78. -----------------------------------------------------------------------------
  79. 3. Basic Use
  80. -----------------------------------------------------------------------------
  81.  
  82. MedDLe has no GUI at this point. Live with it.
  83.  
  84. MedDLe is can both be used to view and edit mdl files. To
  85. start the program just type 'mdl file.mdl' where 'file.mdl'
  86. is a valid mdl filename.
  87.  
  88. You start in 3D mode (unless you use the -2 switch).
  89. The keys here are (usually press once to turn on and again to turn off):  
  90. !!!!
  91. This changed(ver 1.3)! Run mdl and hit '1' for the low down.
  92. !!!!
  93.     c: cycle animation frames
  94.     v: view vertices
  95.     w: view wireframe
  96.     f: view flat shading
  97.     g: view gouraud shading (not enough quake info for this yet)
  98.     t: view texture mapping
  99.     h: view header info
  100.     b: change background color
  101.     2: goto 2D mode
  102.     UP ARROW: move view point up
  103.     DOWN ARROW: move view point down
  104.     RIGHT ARROW: goto next animation frame
  105.     LEFT ARROW: goto previous animation frame
  106.     Esc: quit the program
  107.  
  108.     MOUSE LEFT/RIGHT: rotate object around z-axis
  109.     MOUSE UP/DOWN + LEFT BUTTON: zoom in/out
  110.     MOUSE UP/DOWN + RIGHT BUTTON: rotate object around y-axis
  111.  
  112. Just think of the mouse as your hand grabbing the object. It should
  113. then be easy to control. If you hit the '2' key, you will go to
  114. 2D mode. Here the keys are:
  115.  
  116.     v: view vertices
  117.     w: view wireframe
  118.     s: save mdl file    <---------- Remember
  119.     3: goto 3D mode
  120.     Esc: quit the program
  121.  
  122. The mouse can be used to move vertices in this mode.
  123.  
  124. To import a BMP file, at the command line type:
  125.         mdl -i file.bmp file.mdl
  126. To export a BMP file type:
  127.         mdl -e file.bmp file.mdl
  128.  
  129. NOTE: When you use MedDLe, it will read the original mdl files from
  130. the quake/progs directory but will do all saving and reading from the
  131. current directory. If you load MedDLe in your quake/progs directory,
  132. you may end up erasing something you wish you hadn't.
  133.  
  134. -----------------------------------------------------------------------------
  135. 4. Editing MDL files
  136. -----------------------------------------------------------------------------
  137.  
  138. The following explains the basic proceedure for replacing object textures.
  139. In this example the 'player.mdl' file is modified with the texture
  140. 'play1.bmp'.
  141.  
  142.     1. First export the original texture. It will be saved in your
  143.     MedDLe directory.
  144.     'mdl -e play0.bmp player.mdl'
  145.  
  146.     2. Now go off and modify the texture in your favorite paint
  147.     program. Make sure you use the original palette of the 'play0.bmp'
  148.     file. Save the modified texture as 'play1.bmp' and place it in your
  149.     MedDLe directory.
  150.  
  151.     3. Import the new texture.
  152.     'mdl -i play1.bmp player.mdl'
  153.  
  154.     4. Get into 2D mode (hit '2'). Now press 'v' and 'w' to show the
  155.     polygon mapping. You can use the mouse to tweak some of the vertices.
  156.     You want to make sure that you don't change the original layout
  157.     too much, but also want to make sure there is no background showing
  158.     through any of the polygons. You should toggle back and forth between
  159.     2D mode and 3D mode to check that the texture mapping is ok. When
  160.     your done tweaking, PRESS 's' IN 2D MODE to save your changes.
  161.  
  162.     NOTE: If you don't press 's' in 2D mode your imported texture
  163.     will NOT be saved!
  164.  
  165.     5. Copy the new 'player.mdl' file to the quake/progs directory.
  166.     You may want to back up the original 'player.mdl' before doing this.
  167.  
  168.     6. Run QUAKE!
  169.  
  170. -----------------------------------------------------------------------------
  171. 5. History
  172. -----------------------------------------------------------------------------
  173. v1.3
  174.     -includes source with public release
  175.     -gouraud shading with colormap
  176.     -new file format support
  177.     -help screens
  178.     -more comments in source and some cleaning
  179. v1.2
  180.     -released with source
  181.     -better mouse control
  182. v1.1
  183.     -not released-gui experiments
  184.     -gouraud shading
  185. v1.0
  186.     -now you can edit the 2d vertices
  187.     -fixed bugs which caused crashes in 3d mode
  188.     -expanded video support via GRX20
  189.     -added flat shading to 3d models and texture mapping
  190.     -you can now cycle through the frames of animation
  191.     -several other little things
  192. v0.1
  193.     -added wire frame 3d view
  194.     -added importing/exporting BMP files
  195. v0.00002
  196.     - same as v0.00001 but with correct palette
  197. v0.00001 (not released, except on IRC)
  198.     - displayed the skin texture
  199.  
  200. ------------------------------------------------------------------------------
  201.  
  202. Programmers Note: in this version GRX20 was used along with 3DGPL.
  203. I sorta merged the two together and stuck some of my own stuff in there.
  204. The program is not optimized at all, and a sharp eye will notice that
  205. there is no _perspective_ texture mapping. Oh well, maybe I'll get around
  206. to that in a later version. Or maybe not.
  207.  
  208. Special thanks goes out to...
  209. Chris Babcock for making me aware of the frame data
  210. Raphael Quinet and Sean Werkema for giving out their source which
  211.   made learning to read BMP files easy (also the source taught me a few tricks)
  212. Sergei Savchenko for 3DGPL. I learned a lot of 3D programming from that and
  213.   use several modified versions of his routines for clipping and stuff.
  214. DJGPP v2 and the excellent GRX20 graphics lib.
  215. Id for quake.
  216. Becky for putting up with me :)
  217.  
  218. -end document---------------------------------------------